home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Serious Demos / XTension demo / XTension manual 2.0 / XTension manual 2.0.rsrc / TEXT_157.txt < prev    next >
Text File  |  1998-07-18  |  2KB  |  72 lines
  1.  
  2. Special verbs for external Human Interface Applications 
  3.  
  4. There are many applications that can either provide special human interfaces, or that simply need to be able to 'tell' XTension to 'do things' to items in the database.
  5.  
  6. all of list: Return a 'list' of all verbs, globals, and groups 
  7.  all of list  string  -- verbs, globals, groups
  8.     example : 
  9.  
  10. set aList to "" as list
  11. set aList to all of list "Globals"
  12. write log "we got this many global scripts: " & (count of items of aList)
  13.  
  14. repeat with x from 1 to count of items of aList
  15.     set z to item x of aList
  16.     write log "Like this : " & z
  17. end repeat
  18.  
  19. Thus, you can gain access to all of the global scripts, all of the verbs that XTension serves, and the names of all of the Groups in your database.
  20.  
  21. all of group: Return a 'list' of all units in a specified 'Group'
  22.  all of group  string  -- name of Group,
  23.     example : 
  24.  
  25. set aList to "" as list
  26. set uList to "" as list
  27. set aList to all of list "Groups"
  28. write log "we got this many Groups: " & (count of items of aList)
  29.  
  30. repeat with x from 1 to count of items of aList
  31.     set g to item x of aList
  32.     write log "In group : " & g & " we have these units : "
  33.     set uList to all of group g
  34.     repeat with z from 1 to count of items of uList
  35.         set u to item z of uList
  36.         write log " : " & u
  37.     end repeat
  38. end repeat
  39. write log "Last unit of last group is : " & last item of uList
  40.  
  41.  
  42. add unit to group Add a unit to a named group
  43.  add string to group  string  -- Name of Database Unit and name of Group
  44. remove unit from group Remove a unit from a named group
  45.  add string to group  string  -- Name of Database Unit and name of Group
  46.  
  47.     examples : 
  48.  
  49. add unit "Front Door Light" to group "Night Lights"
  50. remove unit "Front Door Light" from group "Night Lights"
  51.  
  52. Now you can see the need for the next command...
  53.  
  54. unit type: Return a 'list' of all units of a specified 'type'
  55.  unit type  string  -- all, real, dimmable, analog, discrete
  56.     example : 
  57.  
  58. set aList to "" as list
  59. set aList to unit type "analog"
  60.  
  61. write log "we got this many analog units: " & (count of items of aList)
  62. write log "and here's their names and current value:"
  63. repeat with x from 1 to count of items of aList
  64.     set u to item x of aList
  65.     write log " : " & u & (value of u)color green
  66. end repeat
  67.  
  68. There is much to be done in this area, but until XTension adopts the entire 'object model', these new verbs will provide a great deal of flexibility to any external application or applet.
  69.  
  70.  
  71.  
  72.